home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 34.zip / BS1 part 34 / FredFish PD 316.adf / SmartIcon / SmartIcon.doc < prev    next >
Text File  |  1990-02-06  |  5KB  |  133 lines
  1.  
  2.  
  3.           SmartIcon                                             Version 2.0
  4.  
  5.  
  6.  
  7.  
  8.  
  9.           NNAAMMEE
  10.  
  11.                smarticon - Intuition object iconifier
  12.  
  13.  
  14.           SSYYNNOOPPSSIISS
  15.  
  16.                smarticon - no options, runs from Shell or Workbench
  17.  
  18.  
  19.           DDEESSCCRRIIPPTTIIOONN
  20.  
  21.                SmartIcon is an  Intuition object iconifier. This is release
  22.                2.0. It is still limited to windows but does not present the
  23.                problems of  v1.0 anymore,  due to  a completely new  way of
  24.                handling iconified objects and to cleaner code.
  25.  
  26.                Smarticon runs  from a Shell  or from the  Workbench. If you
  27.                run it from  a Shell, you will probably want  to launch as a
  28.                background task  - it does  not detach itself.  When loaded,
  29.                the  program  immediately  patches  all the  opened  windows
  30.                having depth gadgets,  then changes some rom vectors so that
  31.                any window opening after it was loaded gets patched too. The
  32.                patch consists of an extra iconification gadget in the right
  33.                side  of the  title bar. For  display reasons,  the original
  34.                system depth gadgets are replaced by smaller ones, but their
  35.                operation is not changed.
  36.  
  37.                When an iconification gadget is selected, the according win-
  38.                dow is  removed from the display, and it's  name is added in
  39.                the list  of the  Smarticon window. Double-clicking  on this
  40.                name  will then  recall it.  Note  that iconifying  a window
  41.                *releases* memory, and better, releases chip memory. This is
  42.                especially true when  you iconify a large window which over-
  43.                lapped several others for instance.
  44.  
  45.                The SmartIcon window  cannot be iconified itself, this would
  46.                be a vicious cycle.  It can however be removed from the dis-
  47.                play by selecting it's Close gadget which does not terminate
  48.                the program but rather puts  it to sleep until it is invoked
  49.                again from the Shell or Workbench. All the iconified windows
  50.                are accessible again when it wakes up.
  51.  
  52.                The program  can be killed by  selecting the "Shutdown" menu
  53.                option or by sending it a Ctrl-C or Break C. If some windows
  54.                are iconified  when a termination sequence  is invoked, they
  55.                will all be recalled before the program returns. Killing can
  56.                occur while the program is awake or asleep.
  57.  
  58.                The "Save Settings" menu option currently saves the window's
  59.                position in "s:.sirc".   This file is looked for and eventu-
  60.                ally used when the programs starts.
  61.  
  62.  
  63.  
  64.           Utilities                     Page 1                        Amiga
  65.  
  66.  
  67.  
  68.  
  69.           SmartIcon                                             Version 2.0
  70.  
  71.  
  72.  
  73.  
  74.  
  75.           WWIINNDDOOWW RREEFFRREESSHHIINNGG
  76.  
  77.                One problem  with iconification  is that the  information in
  78.                the window layer is lost for most windows - depending on the
  79.                window's  refresh  type.  However, most  applications  using
  80.                sizeable simple  refresh windows  are able to  rebuild their
  81.                display  upon   receival  of  refresh   or  newsize  events.
  82.                SmartIcon will  work just fine with these,  for it will send
  83.                the appropriate messages.  But any simple refresh window not
  84.                able to rebuild itself - like a Shell - or any smart refresh
  85.                window will probably look altered when recalled. This is not
  86.                a bug  and will remain  as is in future  releases - programs
  87.                run properly anyhow.
  88.  
  89.  
  90.           CCOOMMPPIILLIINNGG
  91.  
  92.                A makefile is provided for use with the Lattice C Compiler.
  93.  
  94.  
  95.           BBUUGGSS
  96.  
  97.                The program was  almost completely re-written since v1.0 and
  98.                should now be safe.   All the problems with window names are
  99.                gone. Also, use of iconification gadgets is now fully system
  100.                transparent while it wasn't before - some fake messages went
  101.                through to applications and caused unexpected results.
  102.  
  103.                No bugs are known. Reports are welcome.
  104.  
  105.  
  106.           AAUUTTHHOORR
  107.  
  108.                This programs was written by:
  109.  
  110.                     Gauthier Groult
  111.                     33, Blvd Saint Denis
  112.                     92400 Courbevoie
  113.                     France, Europe
  114.                     Tel: (1) 47 89 09 54
  115.                     EMail: groult@germinal.ibp.fr
  116.  
  117.                SmartIcon 2.0 and  executable and sources are public domain.
  118.                A shareware support of $15 or equivalent would be welcome.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.           Utilities                     Page 2                        Amiga
  131.  
  132.  
  133.